home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / lbas.arc / LBAS.DOC next >
Text File  |  1986-04-20  |  4KB  |  102 lines
  1.  
  2.           LBAS  Label Basic Translator Program
  3.           ====================================
  4.  
  5.   Author:       Jack Botner
  6.   Date Written: November, 1982
  7.   Last Updated: April, 1983
  8.  
  9.   This program was written at home on my own time and I am
  10.   making it available for IBM Internal Use.
  11.  
  12. Changes incorporated in version 12/82:
  13.   - TAB character is now replaced with a blank so tabs may be
  14.     present in the input.
  15.   - "Between double quotes" flag turned off when a new line
  16.     is begun, to limit scope of impact if closing " is missing.
  17.   - Test inserted to make sure user has enough memory available.
  18.   - Warning issued when output file will be overwritten.
  19.   - Dependance on copy code control block storage definitions removed.
  20.  
  21. Changes incorporated in version 04/83:
  22.   - Fixed bug which caused program to fail "insufficient memory"
  23.     when system has 512K or more storage.
  24.   - Changed diskette I/O to block read and write, for up to 5 times
  25.     improved run times.
  26.   - Now allows "comment" lines where the first line is the "sun"
  27.     symbol (also known as squashed bug symbol) (character 15 decimal).
  28.   - Now ignores blank lines.
  29.  
  30. PCLIB contents:
  31.   LBAS EXEEXP is an EXPORTED version of LBAS.EXE.
  32.   LBAS EXETBH is a B3277 binary version of LBAS.EXE.
  33.   LBAS ASM    is the PC-assembler source code (no tabs).
  34.   LBAS DOC    is this document, in plain text.
  35.  
  36. Description:
  37.   This program translates "label basic" programs into proper
  38.   basic format acceptible to the PC Basic interpreter. It is
  39.   written in assembly language for speedy execution.
  40.  
  41.   "Label basic" programs can be thought of as Basic programs
  42.   with two differences:
  43.   1. There are no sequence numbers at the beginning of each
  44.      statement.
  45.   2. Statement locations required by GOTO, GOSUB, ON ERROR, etc.
  46.      are referenced by labels instead of statement numbers.
  47.  
  48.   "Label basic" programs have the following advantages:
  49.   1. The program can be entered and maintained using a PC
  50.      full-screen editor.
  51.   2. The programmer need not concern himself with statement numbers
  52.      and renumbering the program. Statements and subroutines are
  53.      referenced symbolically.
  54.  
  55.   The disadvantage of "label basic", of course, is that you have to
  56.   maintain the "label basic" source and run the program through the
  57.   translator before it is useable by Basic. However, this translator
  58.   runs quite fast, more than 10 times faster than the version
  59.   which runs under the Basic interpreter. (Credit must be given
  60.   to Dave Chess, who inspired the idea of label basic.)
  61.  
  62.   A label is defined as any non-blank string of characters beginning
  63.   with an '!' symbol and containing at least one additional character.
  64.   The maximum label length supported by this program is 16 characters
  65.   (including the !). The program has room for 256 labelled state-
  66.   ments. These limitations are somewhat arbitrary and could be
  67.   changed if necessary. Labels found inside literals (i.e. between
  68.   double quotes) will be ignored. Each statement can be "labelled"
  69.   only once.
  70.  
  71.   The maximum file size which can be processed by this program is
  72.   64K bytes. This is because the entire file is read into one data
  73.   segment of main storage for processing, thus avoiding having to
  74.   read the file from disk twice. Therefore, your PC must have
  75.   at least 96K of memory to run LBAS. If insufficient memory is
  76.   available, the program will terminate with an error message.
  77.  
  78.   Files used as input to this program should have a file extension
  79.   of "LBA". (This can be overridden, but the program will be easier
  80.   to run with the default file extension.) The output file will
  81.   be created with the same filename, and given a file extension of
  82.   "BAS". This will be in a format compatible with Basic ASCII files.
  83.   The output file will always be created on the same disk as the
  84.   input file.
  85.  
  86.   To run the program, enter (from DOS):
  87.  
  88.              LBAS <d:>filename<.filext>
  89.  
  90.   where d: overrides the default disk drive if necessary, and
  91.   .filext overrides the default file extension (.LBA). If you
  92.   omit the filename on the command, you will be prompted for it.
  93.  
  94.   Each TAB character is replaced with a blank, so tabs may be
  95.   present in the input file. No attempt is made to maintain
  96.   original spacing of the lines, however.
  97.  
  98.   To report any problems or suggestions, please contact the
  99.   author at VM TOROLAB(BOTNER).
  100. 
  101.  
  102. the li